home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / text / hyper / hsc.readme < prev    next >
Text File  |  1998-01-05  |  11KB  |  246 lines
  1. Short:    V0.915; html-preprocessor (bin+docs)
  2. Author:   Thomas Aglassinger <agi@giga.or.at>
  3. Uploader: Thomas Aglassinger <agi@giga.or.at>
  4. Version:  0.915
  5. Type:     text/hyper
  6. Kurz:     html-Vorarbeiter
  7. Requires: AmigaOS 2.04, 68020, 2MB, UserIQ>50
  8.  
  9. TITLE
  10.  
  11.   hsc - html sucks completely
  12.  
  13. VERSION 
  14.  
  15.   0.915
  16.  
  17. AUTHOR
  18.  
  19.   Thomas Aglassinger <agi@giga.or.at>
  20.  
  21. DESCRIPTION
  22.  
  23.   Hsc is a developer tool for html-projects.
  24.  
  25.   It can be used on any html file and creates a new html file as
  26.   output. In the input file, you may use an extended syntax based on
  27.   html, but which also allows extensions like macros, conditionals and
  28.   more.
  29.  
  30.   It's mainly intended to create and maintain larger html projects. As
  31.   a CLI-only tool, it should be used with `make'; a dependency
  32.   generator is included.
  33.  
  34.   Hsc is *not* a tool to make html easier for beginners; It's a tool
  35.   to make html a bit less painful and brain-damaged for people who
  36.   already know how to work with it.
  37.  
  38. FEATURES
  39.  
  40.   - macros (implemented as additional tags)
  41.   - conditionals (if/else/elseif)
  42.   - expressions, supporting
  43.     - string concatenation and comparison,
  44.     - import of environment variables
  45.     - current time
  46.     - size of files
  47.   - special tags to
  48.     - include files (also sources)
  49.     - execute shell commands (and include output)
  50.     - add comments in a reasonable way
  51.   - for local links, checks if file/id exists
  52.   - project relative URIs
  53.   - replaces special characters by entities
  54.   - evaluates attributes for image size (PNG/jfif/gif)
  55.   - strips comments and specified tags
  56.   - strips useless white spaces
  57.   - replaces icon entities by images
  58.   - performs a basic syntax- and structure check
  59.   - easy to extend syntax definition format
  60.   - maintains a project file
  61.   - dependency generator for Makefiles included
  62.   - tool to examine/manipulate project files included
  63.  
  64. NEW FEATURES
  65.  
  66.   - ported to NeXTStep, AmigaOS/ixemul.library and BeOS
  67.   - conditional assignments
  68.   - as usual, some minor bugfixes and improvements
  69.  
  70. SPECIAL REQUIREMENTS
  71.  
  72.   AmigaOS 2.04, 2MB of regular memory, 68020, some sort of WWW-browser
  73.   and ASCII editor.
  74.  
  75.   For larger projects, 4MB of memory and 68040 are recommended.
  76.  
  77.   Different to most other WWW-tools, hsc requires an user-IQ > 50. You
  78.   should also know how to work with the CLI and how to write
  79.   Makefiles. You should already made have some experiences with macro
  80.   processors and some programming language (Rexx should suffice).
  81.  
  82. AVAILABILITY
  83.  
  84.   - Every Aminet-mirror, file "text/hyper/hsc.lha"; for example
  85.     "ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc.lha"
  86.   - "http://www.giga.or.at/~agi/hsc/"
  87.  
  88. PRICE
  89.  
  90.   Freeware.
  91.  
  92. DISTRIBUTABILITY
  93.  
  94.   Distributed under GNU General Public License.
  95.  
  96. SOURCE CODE
  97.  
  98.   ANSI-C source code is available in a separate archive (look for
  99.   `hsc-source.lha' at the same site you've got the binaries from).
  100.  
  101.  
  102. ============================= Archive contents =============================
  103.  
  104. Original  Packed Ratio    Date     Time    Name
  105. -------- ------- ----- --------- --------  -------------
  106.       37      37  0.0% 02-Nov-97 23:52:58  FILE_ID.DIZ
  107.      628     279 55.5% 09-Jun-97 07:21:02  hsc.info
  108.    28015   10821 61.3% 02-Nov-97 23:37:54 +CHANGES
  109.      463     242 47.7% 31-May-97 02:47:38 +CHANGES.info
  110.    17982    6993 61.1% 26-Jun-95 08:31:52 +COPYING
  111.      463     242 47.7% 31-May-97 02:47:38 +COPYING.info
  112.      628     269 57.1% 02-Jun-97 04:25:02 +docs-source.info
  113.      436     262 39.9% 10-Oct-97 02:01:02 +README
  114.      463     238 48.5% 02-Jun-97 04:24:52 +README.info
  115.      628     271 56.8% 31-May-97 02:47:38 +docs.info
  116.     5056    2343 53.6% 02-Nov-97 23:34:24 +about.html
  117.     6549    2924 55.3% 02-Nov-97 23:35:18 +author.html
  118.     6413    2944 54.0% 02-Nov-97 23:36:30 +bugs.html
  119.     1908     902 52.7% 02-Nov-97 23:35:14 +copy.html
  120.     3610    1433 60.3% 02-Nov-97 23:35:22 +distrib.html
  121.     2336    1042 55.3% 02-Nov-97 23:34:40 +envvar.html
  122.     2251    1007 55.2% 02-Nov-97 23:34:26 +examples.html
  123.     6741    2536 62.3% 19-Oct-97 20:43:48 +assign.html
  124.     1686     752 55.3% 02-Nov-97 23:34:38 +checkuri.html
  125.     9690    3610 62.7% 02-Nov-97 23:36:42 +exec.html
  126.     6347    2228 64.8% 02-Nov-97 23:36:20 +expressions.html
  127.     6025    2653 55.9% 02-Nov-97 23:35:32 +getsize.html
  128.     4657    1713 63.2% 02-Nov-97 23:36:46 +if.html
  129.     8504    3565 58.0% 02-Nov-97 23:36:50 +prefs.html
  130.     2159    1052 51.2% 02-Nov-97 23:34:32 +rplcent.html
  131.    13106    3722 71.6% 02-Nov-97 23:35:54 +spcattr.html
  132.    13223    4868 63.1% 02-Nov-97 23:36:02 +spctags.html
  133.     3864    1655 57.1% 02-Nov-97 23:35:58 +strip.html
  134.     1845     847 54.0% 02-Nov-97 23:36:52 +syntax.html
  135.     5871    2408 58.9% 02-Nov-97 23:35:26 +uris.html
  136.     5885    2320 60.5% 02-Nov-97 23:34:48 +fileargs.html
  137.     7567    3300 56.3% 02-Nov-97 23:35:00 +future.html
  138.      103     103  0.0% 06-Jun-97 23:32:02 +austria.gif
  139.      138     138  0.0% 14-Jan-96 17:27:46 +back.gif
  140.      190     190  0.0% 14-Jan-96 17:20:08 +copy.gif
  141.      368     368  0.0% 04-Oct-97 02:12:50 +designed.gif
  142.      140     140  0.0% 06-Jun-97 23:31:34 +english.gif
  143.      638     638  0.0% 26-May-96 02:10:44 +hsc.gif
  144.      170     170  0.0% 14-Jan-96 17:14:34 +index.gif
  145.      176     176  0.0% 14-Jan-96 17:14:44 +main.gif
  146.      189     189  0.0% 14-Jan-96 17:15:02 +next.gif
  147.      347     347  0.0% 12-Oct-96 18:51:36 +niceguy.gif
  148.      168     168  0.0% 14-Jan-96 17:28:12 +noback.gif
  149.      211     211  0.0% 14-Jan-96 17:20:36 +nocopy.gif
  150.      200     200  0.0% 14-Jan-96 17:15:28 +noindex.gif
  151.      193     193  0.0% 14-Jan-96 17:15:40 +nomain.gif
  152.      212     212  0.0% 14-Jan-96 17:15:52 +nonext.gif
  153.      213     213  0.0% 15-Jul-96 23:44:28 +noprev.gif
  154.      188     188  0.0% 14-Jan-96 17:16:08 +prev.gif
  155.      111     111  0.0% 06-Jun-97 23:32:22 +teutsch.gif
  156.      141     141  0.0% 04-Nov-95 02:20:36 +up.gif
  157.     7109    2621 63.1% 02-Nov-97 23:35:50 +index.html
  158.      463     245 47.0% 04-Mar-97 04:41:40 +index.html.info
  159.     4761    2079 56.3% 02-Nov-97 23:36:38 +install.html
  160.     4996    1796 64.0% 02-Nov-97 23:34:16 +attrib.html
  161.     4646    1675 63.9% 02-Nov-97 23:35:12 +flag.html
  162.     9480    3533 62.7% 02-Nov-97 23:34:56 +macros.html
  163.    27171    8597 68.3% 02-Nov-97 23:35:08 +messages.html
  164.    12928    4978 61.4% 02-Nov-97 23:34:44 +options.html
  165.     6282    2744 56.3% 02-Nov-97 23:36:28 +others.html
  166.     6880    2985 56.6% 02-Nov-97 23:36:34 +ports.html
  167.     3481    1408 59.5% 02-Nov-97 23:35:44 +hscdepp.html
  168.     2297    1041 54.6% 02-Nov-97 23:35:46 +hscpaltrow.html
  169.     7229    2624 63.7% 02-Nov-97 23:35:30 +hscpitt.html
  170.     1903     746 60.7% 02-Nov-97 23:34:34 +index.html
  171.     6644    2920 56.0% 02-Nov-97 23:34:20 +make.html
  172.     4770    1933 59.4% 02-Nov-97 23:35:40 +makefile.html
  173.     2981    1278 57.1% 02-Nov-97 23:35:36 +prjfile.html
  174.     8874    3512 60.4% 02-Nov-97 23:34:52 +questions.html
  175.     4308    1886 56.2% 02-Nov-97 23:36:10 +related.html
  176.     3541    1645 53.5% 02-Nov-97 23:34:30 +require.html
  177.    11518    4851 57.8% 02-Nov-97 23:36:14 +source.html
  178.     2584    1189 53.9% 02-Nov-97 23:36:18 +teutsch.html
  179.     3761    1685 55.1% 02-Nov-97 23:36:24 +undocumented.html
  180.     4008    1767 55.9% 02-Nov-97 23:36:06 +updates.html
  181.      628     278 55.7% 08-Jun-97 10:44:16 +examples.info
  182.      628     273 56.5% 08-Jun-97 10:44:16 +advanced.info
  183.      200     132 34.0% 03-Jun-97 03:59:10 +README
  184.      463     239 48.3% 03-Jun-97 03:00:22 +README.info
  185.      628     271 56.8% 08-Jun-97 10:44:16 +fetzenschaedl.info
  186.      347     347  0.0% 12-Oct-96 18:51:36 +hugo.gif
  187.      217     172 20.7% 23-Oct-95 02:54:30 +hugo.hsc
  188.     1104     514 53.4% 30-Sep-96 04:55:44 +macro.hsc
  189.      398     257 35.4% 23-Jul-96 14:13:18 +main.hsc
  190.      581     295 49.2% 03-Jun-97 03:05:30 +Makefile
  191.     2497    1168 53.2% 03-Jun-97 03:51:46 +README
  192.      463     238 48.5% 03-Jun-97 03:00:22 +README.info
  193.      178     139 21.9% 16-Sep-95 23:32:32 +stupid.hsc
  194.      628     274 56.3% 08-Jun-97 10:44:16 +simple.info
  195.       55      55  0.0% 09-Mar-97 21:33:14 +README
  196.     2589    1126 56.5% 03-Jun-97 03:58:14 +README
  197.      463     241 47.9% 03-Jun-97 03:00:22 +README.info
  198.      347     347  0.0% 12-Oct-96 18:51:36 +hugo.gif
  199.      217     172 20.7% 23-Oct-95 02:54:30 +hugo.hsc
  200.     1104     514 53.4% 30-Sep-96 04:55:44 +macro.hsc
  201.      398     257 35.4% 23-Jul-96 14:13:18 +main.hsc
  202.      752     358 52.3% 03-Jun-97 03:54:44 +Makefile
  203.      178     139 21.9% 16-Sep-95 23:32:32 +stupid.hsc
  204.      628     274 56.3% 31-May-97 02:47:38 +grafflwerk.info
  205.     3173    1496 52.8% 30-Jul-96 12:47:06 +hScMsg.rexx
  206.      513     274 46.5% 29-Mar-97 15:59:22 +hScMsg.rexx.info
  207.     5178    1994 61.4% 15-Apr-97 22:19:14 +hscpaltrow.rexx
  208.      517     286 44.6% 15-Apr-97 22:16:58 +hscpaltrow.rexx.info
  209.     1279     581 54.5% 28-Mar-97 21:15:26 +README
  210.      463     240 48.1% 29-Mar-97 15:59:22 +README.info
  211.     2108    1060 49.7% 20-Feb-97 00:44:06 +SendBrowser.rexx
  212.      518     282 45.5% 29-Mar-97 15:59:22 +SendBrowser.rexx.info
  213.     3337    1507 54.8% 04-Aug-96 23:27:42 +SendScMsg.rexx
  214.      516     278 46.1% 29-Mar-97 15:59:22 +SendScMsg.rexx.info
  215.      455     289 36.4% 12-Oct-97 18:29:22 +StripNastyChars.hsc
  216.      604     364 39.7% 16-Oct-97 19:36:24 +StripNastyChars.rexx
  217.    99148   54364 45.1% 02-Nov-97 22:34:16 +hsc
  218.      467     209 55.2% 03-Jun-97 22:07:08 +hsc.info
  219.    14682    3686 74.8% 18-May-97 22:36:12 +hsc.prefs
  220.    46568   25182 45.9% 02-Nov-97 22:34:30 +hscdepp
  221.      467     209 55.2% 03-Jun-97 22:07:08 +hscdepp.info
  222.    46088   25454 44.7% 02-Nov-97 22:34:42 +hscpitt
  223.      467     209 55.2% 03-Jun-97 22:07:08 +hscpitt.info
  224.      383     250 34.7% 02-Oct-97 00:20:32 +IMPORTANT
  225.      463     238 48.5% 31-May-97 02:47:38 +IMPORTANT.info
  226.     2930    1377 53.0% 04-Oct-97 16:15:56 +NEWS
  227.      463     242 47.7% 31-May-97 02:47:38 +NEWS.info
  228.     2605    1389 46.6% 02-Nov-97 23:53:04 +README
  229.      463     243 47.5% 31-May-97 02:49:56 +README.info
  230.      628     276 56.0% 31-May-97 02:47:38 +source.info
  231.      421     257 38.9% 14-Sep-97 22:50:00 +README
  232.      463     240 48.1% 29-Mar-97 01:20:16 +README.info
  233.      628     278 55.7% 31-May-97 02:47:38 +starter-project.info
  234.      628     273 56.5% 20-Mar-97 01:36:20 +html.info
  235.       99      80 19.1% 20-Mar-97 01:39:36 +Welcome.html
  236.      691     363 47.4% 26-Mar-97 14:27:40 +README
  237.      463     242 47.7% 20-Mar-97 01:35:16 +README.info
  238.      628     274 56.3% 20-Mar-97 01:35:22 +source.info
  239.      194     166 14.4% 20-Mar-97 01:39:36 +hsc.project
  240.     1365     707 48.2% 26-Mar-97 14:25:50 +Makefile
  241.      464     230 50.4% 20-Mar-97 01:32:36 +Makefile.info
  242.       99      80 19.1% 20-Mar-97 01:33:58 +Welcome.hsc
  243.      464     230 50.4% 31-Mar-97 23:38:50 +Welcome.hsc.info
  244. -------- ------- ----- --------- --------
  245.   588528  266791 54.6% 10-Nov-97 01:37:34   138 files
  246.